home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / RUBPB22A.ARJ / RUP22C.EXE / MANUAL.6 < prev    next >
Text File  |  1991-05-03  |  13KB  |  311 lines

  1.                 _________________________
  2.                |                         |
  3.                |  Section 6: PARAGRAPHS  |
  4.                |_________________________|
  5.  
  6.  
  7. CONTENTS
  8.  
  9. 6.1 Indentation and Paragraphs
  10. 6.2 Horizontal Tab Mode
  11. 6.3 Vertical Tab Mode
  12.  
  13.  
  14. 6.1 INDENTATION AND PARAGRAPHS
  15.  
  16. The following tags are relevant to paragraphing:
  17.  
  18. <QP>  Quad Paragraph:  End Current Line; justify it in accordance with
  19. the current scheme of justification, unless the current scheme is full
  20. justification (<XR>) in which case left-justify the line; move the
  21. printhead down one line. and  and Paragraph, advance printhead
  22. down the page by the line leading plus the inter-paragraph leading.
  23.  
  24. <APL> Advance Printhead by Inter-Paragraph Leading (Note: If this tag is
  25. used, it must appear on a line by itself, like a `directive'.) 
  26.  
  27. A "paragraph" is a sequence of one or more text lines terminated by a
  28. "Quad" tag and/or by a blank line. If a blank line is present, the
  29. Publisher will insert an implicit <APL> tag into it; and if the last
  30. line before the blank line does not end with a "Quad" tag, the Publisher
  31. will insert an implicit <QP> tag. 
  32.  
  33. The variables which control the appearance of paragraphs, within the
  34. confines of the defined column, are the left-indent, right-indent, and
  35. para-indent. The para-indent, used only on the first line of a
  36. paragraph, and the left-indent, used on all other lines, are measured
  37. from the left edge of the column. The right-indent, measured from the
  38. right edge of the column, applies to all lines.
  39.  
  40. <ILd>  Set Left-Indent = d
  41.  
  42. <IRd>  Set Right-Indent = d
  43.  
  44. <IPd>  Set Para-Indent = d
  45.  
  46. <IBd>  Set Left- and Right-Indent = d
  47.  
  48. <ITL>  Set Left-Indent to current print position 
  49.  
  50. <ITR>  Set Right-Indent to current print position 
  51.  
  52. <IHd>  Set Left-Indent=d, Para-Indent=0  - with d greater than 0,
  53. creates a "hanging paragraph", i.e. a paragraph with the first line
  54. extending farther to the left than the other lines.
  55.  
  56. <IH>   Set Left-Indent=0, Para-Indent=0
  57.  
  58. <IL>   Set Left-Indent = 0
  59.  
  60. <IR>   Set Right-Indent = 0
  61.  
  62. <IP>   Set Para-Indent = 0
  63.  
  64. <IB>   Set Left- and Right-Indent = 0
  65.  
  66. 6.2 HORIZONTAL TAB MODE
  67.  
  68. Horizontal Tab Mode is primarily used to display information in tabular
  69. form, that is, in a table having rows and columns. The layout of the
  70. table is defined by a series of tab stops. Each tab field is bordered on
  71. the left and right by a tab stop. A table with "n" tab fields requires
  72. ("n"+1) tab stops, unless the "nth" tab field is left justified. The
  73. purpose of the ("n"+1)th" tab stop is to provide the missing edge for
  74. the "nth" tab field. This edge is used for centering, right
  75. justification, or full justification of the "nth" tab field. The maximum
  76. number of tab fields is 30 or, equivalently, the maximum number of tab
  77. stops is 31. 
  78.  
  79. A "table style" (or "horizontal tab style") consists of a number of tab
  80. stops. Individual tab stops are input using the following syntax: 
  81.  
  82. <tab i= stop= justify= font=>
  83.  
  84. The order of the parameters is not important. Justification and font 
  85. parameters may be omitted. The syntax and usage of the parameters 
  86. is:
  87.  
  88. i= Tab number (an integer). The ordinal number of the tab stop, counting
  89.    left to right. 
  90.  
  91. stop= Horizontal distance of the current tab stop, measured from the
  92.       left edge of the column (a positive number). Any unit of
  93.       measurement recognized by the Publisher can be used.
  94.  
  95. justify= Default justification for the current tab field (from the
  96.          current tab stop to the next ordinal tab stop). Parameter
  97.          values are "qj", "ql", "qr", or "qc", representing quad
  98.          justify, quad left, quad right, and quad center. See "Alignment
  99.          and Justification" for explanations of these tags. The
  100.          justification parameter is optional. If omitted, justification
  101.          is determined by the current rag setting, or by an explicit
  102.          quad tag terminating the input text for the tab field. Example:
  103.          justify=ql. 
  104.  
  105. font= Default font for the current tab field. Any font tag can be used,
  106.       specifying type family, point size, and stroke weight,
  107.       e.g.<Times12m>. (See "Font Changes".) The font parameter is
  108.       optional. If no font is specified, the contents of the tab field
  109.       will appear in the same font as the text preceeding the first tab
  110.       field of the table. 
  111.  
  112. <HS> - Enter Horizontal Tab Mode
  113.  
  114. <HT> - End text field, print in current tab field, and advance to the
  115.        next tab stop 
  116.  
  117. <HE> - Exit from Horizontal Tab Mode, and advance printhead vertically
  118.        by interline leading 
  119.  
  120. <tab_line thick= > - Print a horizontal line of the specified thickness
  121.                      across the width of the table. If the parameter
  122.                      "thick" is omitted, that is, if you use the tag
  123.                      <tab_line>, the line will be printed in the
  124.                      "default thickness" specified in the setup file or
  125.                      style sheet by the tag <hrule thick= descent= > 
  126.  
  127. EXAMPLE:
  128.  
  129. <tab i=1 stop=0.5in justify=ql><qz>
  130. <tab i=2 stop=2.5in justify=qr><qz>
  131. <tab i=3 stop=3.5in justify=qr><qz>
  132. <tab i=4 stop=4.5in justify=qr><qz>
  133. <tab i=5 stop=5.5in><qz>
  134. <tab_line><ql>
  135. <HS>Item<HT>1985<HT>1986<HT>1987<HE>
  136. <HS>Income<HT>$10,000<HT>$14,000<HT>$19,500<HE>
  137. <HS>Expenses<HT>8,000<HT>11,500<HT>16,000<HE>
  138. <HS>Total<HT>$2,000<HT>$2,500<HT>$3,500<HE>
  139. <tab_line><ql>
  140.  
  141. will appear in print as follows:
  142.      __________________________________________________
  143.      Item                      1985      1986      1987
  144.      Income                 $10,000   $14,000   $19,500
  145.      Expenses                 8,000    11,500    16,000
  146.      Total                   $2,000    $2,500    $3,500
  147.      __________________________________________________
  148.  
  149.  
  150. IMPORTANT NOTE: Any left or right text indentation which is currently in
  151. effect when you enter tab mode, will be applied INSIDE the individual
  152. tab fields, not to the table as a whole. This is useful in complex
  153. table formats, but is not needed in ordinary tables, since you can
  154. simply set the tab stops wherever you want the text to be located: there
  155. is no requirement for indents.
  156.  
  157. Unless you are implementing some unusual special effect, LEFT AND RIGHT
  158. TEXT INDENTS SHOULD BE SET TO ZERO when entering Horizontal Tab Mode. If
  159. the text preceding the table was indented on the left and/or right, the
  160. indent(s) can be cancelled by the tags <IL> and/or <IR>, or the single
  161. tag <IB>. 
  162.  
  163. If you wish the whole table to be indented, this can be done by choosing
  164. suitable values for the first and last tab stops. For example, if tab 1
  165. is set at 0.75in, the left edge of the table will be indented
  166. three-quarters of an inch from the left edge of the column.
  167.  
  168. 6.3 VERTICAL TAB MODE
  169.  
  170. Vertical tab mode is used to control the vertical alignment of paragraphs 
  171. of text located side-by-side in two or more sub-columns within the 
  172. column measure of the page layout.
  173.  
  174. Vertical tab mode is also used to set up tabular presentations in 
  175. which the individual entries are paragraphs or blocks of text, rather 
  176. than single words or numbers. Multilingual formats, consisting of 
  177. two or more sub-columns containing translations of the same text into 
  178. two or more languages, are another important application of vertical 
  179. tab mode.
  180.  
  181. Like horizontal tab mode, vertical tab mode operates within the confines 
  182. of the current column measure: that is, the total width of the sub-column 
  183. structure defined using vertical tab mode must not exceed the column 
  184. measure of the page layout.
  185.  
  186. A "Vertical Tab Style" (or "Vtab Style") is a series of vertical tab
  187. stops which create a corresponding number of sub-columns. These tab
  188. stops are defined by <tab> tags, with the following syntax:
  189.  
  190. <tab i= stop= width= justify= font=>  where
  191.  
  192. i= Tab number
  193.  
  194. stop= Horizontal distance from left edge of column to the tab stop 
  195.  
  196. width= Width of the tab field
  197.  
  198. justify= Default justification for tab field (qj, ql, qr, qc).
  199.  
  200. font= Default font for the tab field. If no font is specified, the text
  201.       in the tab field will appear in the same font as the text
  202.       preceding the start of vertical tab mode. 
  203.  
  204. EXAMPLE:
  205.  
  206. <tab i=1 stop=0.125in width=2.25in justify=ql><QZ>
  207. <tab i=2 stop=2.875in width=2.75in justify=qr><QZ>
  208.  
  209. Sets up a structure of two sub-columns, the left one 2.25" wide, the
  210. right one 2.75" wide, separated by a 1/4" gutter. The left sub-column is
  211. indented 1/8" from the left edge of the column; the left sub-column is
  212. left justified, and the right column is right justified. (Note that this
  213. structure requires a page layout with a Column Measure of at least
  214. 5.375".) 
  215.  
  216. The following Publisher tags are used to enter text into the defined 
  217. sub-column structure:
  218.  
  219. <VS> - Vertical Start: Enter vertical tab mode and establish a baseline.
  220.  
  221. <VC> - Vertical Col: Move the printhead horizontally to the next tab
  222.        stop and vertically to the baseline established by <VS>. 
  223.  
  224. <VE> - Vertical End: Exit from vertical tab mode. Move the printhead
  225.        horizontally to the left edge of the column, and vertically to a
  226.        new baseline that is lower than any baseline visited by the
  227.        printhead, since the <VS> tag. 
  228.  
  229. Within a given sub-column of vertical tab mode, the Publisher
  230. automatically measures and lays out paragraphs, and obeys most tag
  231. commands that are available in normal column mode. These include font
  232. changes, leading, indentation, justification, and more. 
  233.  
  234. Vertical Tab source text for a two-subcolumn structure is set out 
  235. in a series of paragraphs, in which the first, third, fifth (etc.) 
  236. paragraphs are intended to appear in the left-hand subcolumn, and 
  237. the second, fourth, sixth (etc.) paragraphs are intended to appear 
  238. in the right-hand subcolumn. Paragraph one will be aligned beside 
  239. paragraph two, paragraph three beside paragraph four, and so on. The 
  240. series starts with a <VS> tag to initiate vertical tab mode; the two 
  241. paragraphs in each side-by-side pair are separated from each other 
  242. by a <VC> tag, and from the next pair by <VE> and <VS> tags.
  243.  
  244. In the nursery rhyme example below, each line ends with a hard line
  245. break,i.e. a <QD> tag, since it is customary to print poetry in this
  246. form. Without these tags, the verses would appear as continuous
  247. paragraphs, with line breaks only where required by the sub-column
  248. widths, but they would still be in side-by-side alignment. The Vtab
  249. Style consists of two sub-columns of width 0.475 column-widths,
  250. separated by a gutter of .05 column-widths, i.e. one-twentieth of a
  251. column-width. The total width is exactly one column-width. (Note: The
  252. total width of a vtab style cannot be greater than one column-width,
  253. but may be less.) The dimensions of a vtab style can, of course, be
  254. specified in any unit of measurement accepted by the Publisher, but
  255. ther is an advantage to specifying them in column-widths (cl): if you
  256. later decide to change the page layout of the document, vtab style
  257. dimensions specified in column-widths will automatically expand or
  258. contract as necessary to match the new layout. The input text to
  259. produce the example is: 
  260.  
  261. <tab i=1 stop=0.000cl width=0.475cl justify=ql><QZ>
  262. <tab i=2 stop=0.525cl width=0.475cl justify=ql><QZ>
  263. SING A SONG OF SIXPENCE<QC>
  264. <QL>
  265. <VS>
  266. Sing a song of sixpence,<QD>
  267. A pocket full of rye;<QD>
  268. Four-and-twenty blackbirds<QD>
  269. Baked in a pie!<VC>
  270. The king was in his counting-house,<QD>
  271. Counting out his money;<QD>
  272. The queen was in her parlor,<QD>
  273. Eating bread and honey.<VE>
  274. <QL>
  275. <VS>
  276. When the pie was opened<QD>
  277. The birds began to sing<QD>
  278. Wasn't that a dainty dish<QD>
  279. To set before the king?<VC>
  280. The maid was in the garden,<QD>
  281. Hanging out the clothes;<QD>
  282. When down came a blackbird<QD>
  283. And snapped off her nose!<VE>
  284.  
  285. When printed in Vertical Tab mode, it will appear like this:
  286.  
  287.  
  288.                        SING A SONG OF SIXPENCE
  289.  
  290. Sing a song of sixpence,            The king was in his counting-house,
  291. A pocket full of rye;               Counting out his money;
  292. Four-and-twenty blackbirds          The queen was in her parlor,
  293. Baked in a pie!                     Eating bread and honey.
  294.  
  295. When the pie was opened             The maid was in the garden,
  296. The birds began to sing             Hanging out the clothes;
  297. Wasn't that a dainty dish           When down came a blackbird
  298. To set before the king?             And snapped off her nose!
  299.  
  300.  
  301. Vertical tab mode is not limited to two-subcolumn formats: it can handle
  302. as many sub-columns as the page layout has room for. In a three-
  303. subcolumn format, the input text would appear in sequences of three
  304. paragraphs, the first paragraph in each sequence being printed in the
  305. first sub-column, the second paragraph in each sequence being printed in
  306. the second sub-column, and the third paragraph in each sequence being
  307. printed in the third sub-column. <VC> tags would be placed at the ends
  308. of the first and second paragraphs in each sequence, and the third
  309. paragraph of each sequence would be separated from the first paragraph
  310. of the next sequence by <VE> and <VS> tags. 
  311.